home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / uucp / wcnews_1_0_30.lha / man / unsharmap.man < prev   
Text File  |  1992-12-17  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. UNSHARMAP(8)                  wCNews                 UNSHARMAP(8)
  5.  
  6.  
  7. ›1mNAME›22m
  8.        unsharmap - unshar a USENET comp.news.maps article
  9.  
  10. ›1mSYNOPSIS›22m
  11.        ›1munsharmap›22m [›1m-d›22m ›1mdir›22m] [›1m-n›22m ›1mnewsgroups›22m] [›1m-p›22m] <›1mfile›22m|›1mlist›22m >>›1mlog›22m
  12.  
  13. ›1mOPTIONS›22m
  14.        ›1m­d›22m dir        ­ cd to 'dir' before unsharing
  15.        ›1m­n›22m newsgroups ­ colon separated list of allowed newsgroups
  16.        ›1m­p›22m            ­ use stdin (for piped input from 'sys')
  17.  
  18.        where ›1mfile›22m|›1mlist›22m contains either a list of files  that  are
  19.        in the format below or, in conjuction with the ›1m­p›22m flag, is
  20.        itself such a file.
  21.  
  22. ›1mDESCRIPTION›22m
  23.        The USENET map project distributes files in the  following
  24.        format:
  25.  
  26.        The  header,  which starts at the first line and continues
  27.        up until there is a blank line as the follow lins it:
  28.  
  29.           Newsgroups: comp.mail.maps
  30.           Subject: UUCP ...
  31.           Message­ID: ...
  32.           Date: ...
  33.           Approved: ...
  34.  
  35.        These lines are not the complete list, nor do they show up
  36.        in  that  order.   After the header is a blank line.  Next
  37.        comes the shar file preamble which consists of a bunch  of
  38.        lines that begin with a :, followed by the 2 lines:
  39.  
  40.           echo shar: extracting THE­FILE­NAME
  41.           cat << 'SHAR_EOF' > THE­FILE­NAME
  42.  
  43.        what  follows  is  the  map data intended to override THE­
  44.        FILE­NAME in the UNSHAR_MAP_DIR directory.   The  final  3
  45.        lines:
  46.  
  47.           SHAR_EOF
  48.           :   End of shell archive
  49.           exit 0
  50.  
  51.        terminate  the shar file, and are not considered a part of
  52.        the map data.
  53.  
  54.        For each shar file processed, the following information is
  55.        written to stdout:
  56.  
  57.             filename read
  58.             filename written
  59.             subject line
  60.             message­ID
  61.  
  62.  
  63.  
  64. Villa Straylight         17 December 1992                       1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. UNSHARMAP(8)                  wCNews                 UNSHARMAP(8)
  71.  
  72.  
  73.             date
  74.             approved info
  75.             any error message
  76.  
  77.        All error message lines begin with 'error:'.
  78.  
  79.        exits by 0 if there was no errors, non­0 otherwise.
  80.  
  81.        For  automatic  extraction  of new maps, I use an entry in
  82.        ›1muulib:news/sys›22m similar to this one:
  83.  
  84.        automapadm:nbg.config.maps,de.admin.submaps/all::uulib:news/bin/unsharmap <%s >>maps:logfile ­p ­n de.admin.submaps:nbg.config.maps ­d Maps:
  85.  
  86. ›1mSEE›22m ›1mALSO›22m
  87.        relaynews(8), pathalias(8), USENET  groups  ›4mcomp.mail.maps›24m
  88.        and/or ›4mde.admin.submaps›24m.
  89.  
  90. ›1mHISTORY›22m
  91.        /* @(#)unsharmap.c      1.6 2/5/89 14:14:01 */
  92.  
  93.        Copyright (C) 1988 Ronald S. Karr and Landon Curt Noll
  94.  
  95.        See the file COPYING, distributed with smail, for restric­
  96.        tion and warranty information.
  97.  
  98.        Adopted for ›4mAmiga›24m ›4mUUCP›24m ›4mPlus›24m by Ingo Feulner in 1990.  Bug­
  99.        fixed  and  included into ›4mwCNews›24m by Kai 'wusel' Siering in
  100.        1992.
  101.  
  102. ›1mBUGS›22m
  103.        None known (yet =:­>). Version (1.6.1) fixes one nasty bug
  104.        of  the  original  version  (distributed  with  Amiga UUCP
  105.        Plus): if you'd fed it a non­map article  (for  example  a
  106.        cancel message posted to de.admin.submaps), it looped for­
  107.        ever (well, at least unless the device holding  your  log­
  108.        file was full ...) =:­<
  109.        Version 1.6.2 fixes a minor bug in the logging routines.
  110.  
  111.        Please  report  bugs to <bugs@hactar.hanse.de>, preferably
  112.        using the ›4mbugreport›24m script that came  with  wCNews.  Thank
  113.        you.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. Villa Straylight         17 December 1992                       2
  131.  
  132.  
  133.